Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Manipulating Controls /

HideControl

CHANGED WITH THE APPEARANCE MANAGER

Makes the visible control, and any latent embedded controls, invisible.

pascal void HideControl (ControlHandle theControl);

theControl

On input, a handle to the control you want to hide.

DISCUSSION

The HideControl function makes the specified control invisible. This can be useful, for example, before adjusting a control's size and location. It also adds the control's rectangle to the window's update region, so that anything else that was previously obscured by the control will reappear on the screen. If the specified control has embedded controls, HideControl makes the embedded controls invisible as well. If the control is already invisible, HideControl has no effect.

If you call HideControl on a latent embedded control, it would not be displayed the next time ShowControl was called on its embedder control. For a discussion of latency, see "Manipulating Controls".

To make the control visible again, you can use the ShowControl function or SetControlVisibility.

WHEN THE APPEARANCE MANAGER IS NOT AVAILABLE

HideControl only makes the specified control invisible, because embedding hierarchies are not supported.